home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / ctrl3_62.zip / C3.DOC < prev    next >
Text File  |  1991-09-29  |  24KB  |  761 lines

  1.  
  2.  
  3.  
  4.  
  5.                       *******  CONTROL 3  *******
  6.  
  7.                               Version 6.2
  8.  
  9.                        Programmed by Kevin Solway
  10.                             September, 1991
  11.  
  12.  
  13.  
  14. THE NEW VERSION (6.2)
  15.  
  16.    *  Improved handling when there three directories from the same
  17.       drive on the screen.  If all three directories are different,
  18.       then when you copy or move files to a destination on the same
  19.       drive you are given choice between the other two directories,
  20.       rather than the right adjacent window automatically being chosen.
  21.  
  22.    *  Fixed display bug when recovering from renaming error.
  23.  
  24.    *  Improved error messages when executing a file.
  25.  
  26.  
  27.  
  28.  
  29. VERSION 6.1
  30.  
  31.    *  Execute any DOS command as you would from the DOS command line.
  32.       When typing the DOS command you can pull-down the text under the
  33.       highlight bar by hitting Ctrl-Enter to vastly speed up typing.
  34.       Use the up arrow key to recall previously typed DOS commands.
  35.  
  36.    *  Automatically treat files with certain extensions in specified
  37.       ways.  For example, if the highlight bar is on a file with a
  38.       '.ZIP' extension (ie, a file compressed with pkzip), you can
  39.       simply press the return key and automatically run a pkzip -v
  40.       command on it, to view the contents of the archive.  Or, if the
  41.       file is a .DOC or .TXT file, you can configure CONTROL3 to
  42.       automatically run your favourite editor (or text viewing program
  43.       like "list") with the highlighted file as a parameter.  A sample
  44.       .CFG file, which lists a few common file extensions and commands,
  45.       is included in the package.
  46.  
  47.    *  Pressing the backspace key will take you immediately to the
  48.       root directory of the currently logged drive.
  49.  
  50.  
  51. FEATURES:
  52.  
  53.  
  54.    *  Lists directories of THREE drives/directories on screen
  55.       simultaneously.
  56.  
  57.    *  Colour coded directory lists (optional).
  58.  
  59.    *  Execute ANY DOS command, as you would from the normal DOS command
  60.       line.
  61.  
  62.    *  Immediately updates directories after changes ON SCREEN.
  63.  
  64.    *  Lets  you execute, copy, delete, rename and sort files, make and
  65.       remove directories, view and print text files, shell to Dos,
  66.       touch-up file dates and times, change file attributes.
  67.  
  68.    *  Change disk volume labels.
  69.  
  70.    *  DELETE AND COPY WHOLE DIRECTORIES complete with any files and
  71.       directories nested within them.
  72.  
  73.    *  Mini-Editor, ideal for composing or modifying batch files or
  74.       small text files.
  75.  
  76.    *  File encryption.
  77.  
  78.    *  Search and find strings within both text files AND executable files.
  79.  
  80.    *  Lets you move effortlessly through directories and between drives.
  81.  
  82.    *  Proportional disk space indicator;
  83.  
  84.    *  Fast file and directory find.
  85.  
  86.    *  Not copy protected.
  87.  
  88.  
  89.  
  90.  
  91.  
  92. REGISTRATION
  93.  
  94.  
  95.        This program is being released under the shareware concept, if you
  96.    find this program useful you are required to send a registration fee
  97.    of $20 to me at the address below.  Include an extra $5 if you want
  98.    information about updates.
  99.  
  100.  
  101.     Remit to:             Kevin Solway
  102.                           P.O Box 207
  103.                           St Lucia  4067
  104.                           Queensland
  105.                           Australia
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112. OVERVIEW:
  113.  
  114.      "Control 3" is a relatively short and fast program that performs all
  115. commonly used file management operations with a minimum of bother and
  116. from the convenience multi-menu environment.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. USING "CONTROL 3":
  125.  
  126.  
  127.  
  128. Proportional disk space indicator:
  129.  
  130.      On the left hand border of each directory listing you see a bar
  131. indicating the proportion of space used on that drive.
  132.  
  133.  
  134.  
  135.  
  136. Listing a second directory on the screen:
  137.  
  138.      Press F1 to list the directory of Drive A on the screen, F2 for Drive B,
  139. F3 for Drive C  or Alt - (any letter) to list the directory of that drive on
  140. the adjacent part of the screen.
  141.  
  142.  
  143.  
  144.  
  145. Log a new disk:
  146.  
  147.     Press "L" to "L"og a new disk in the same drive indicated by the
  148. highlight bar.
  149.  
  150.  
  151.  
  152.  
  153. Selecting file types:
  154.  
  155.      Press "E" to list executable files, or press "A" to list all files.
  156. Use the "S" option to type in a "S"earch pattern.  For example, the
  157. search pattern "*.doc" will list all the document files on your disk.
  158.  
  159.  
  160.  
  161.  
  162.  
  163. Sorting the file listing:
  164.  
  165.      To locate files more quickly Press "S" (for "S"ort) and you will
  166. be asked if you wish to sort the files by name, extension, size or by
  167. the time/date the file was last written.  Press the appropriate letter.
  168.  
  169.      Once you have sorted the files from a particular drive all files from
  170. that drive will be sorted in subsequent operations until you press Ctrl-S
  171. to re-log the disk and unsort the files.
  172.  
  173.  
  174.  
  175.  
  176.  
  177. Moving about in the directory listing:
  178.  
  179.      Use the up and down arrow keys to move up and down a single line in
  180. the list.  "End" takes you to the end of the window, "Home" takes you to the
  181. top.  PgUp and PgDn moves one whole window up or down, Ctrl-PgDn takes you
  182. to the last entry in the list and Ctrl-PgUp takes you to the first entry.
  183.  
  184.      Fast name finding: Pressing the F9 key will prompt you for a letter
  185. to use in a directory search.  Press F10 to search for a file.  The
  186. highlight bar will locate at the next directory or filename that starts
  187. with the indicated letter.   This method is much faster than paging
  188. through files when you wish to find a particular name amongst hundreds.
  189.  
  190.  
  191.  
  192. Moving into a directory:
  193.  
  194.      Position the highlight bar over the directory name and press the return
  195. key.
  196.  
  197.  
  198.  
  199.  
  200.  
  201. Moving back to the previous directory:
  202.  
  203.      To move back one directory level you can either position the highlight bar
  204. over the two dots ("..") and press the return key, or simply press "B"
  205. (for "B"ack a directory);
  206.  
  207.      Pressing the backspace key will take you immediately to the root
  208. directory of the currently logged drive.
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215. Make a directory:
  216.  
  217.      Press "M" and type the name of no longer than eight characters.  Then
  218. press the return key.
  219.  
  220.  
  221.  
  222.  
  223.  
  224. Delete a directory:
  225.  
  226.      Position the highlight bar over the directory you wish to remove and
  227. press "D" (same as for deleting files). If the directory is not empty you
  228. will be asked to verify that you wish to delete any files and directories
  229. contained within that directory.
  230.  
  231.      Before using this operation be sure that you really want to delete
  232. ALL the files in the directory.  If you make a mistake and delete files you
  233. wish to keep you will only be able to recover the files if you are in
  234. possession of a good file undelete program.
  235.  
  236.  
  237.  
  238.  
  239. Executing normal DOS commands:
  240.  
  241.      Press the "N" key to be prompted for a normal DOS command argument.
  242. (any instruction to DOS, including execution of programs etc).  Using this
  243. feature you can execute any program on the DOS path with ease.  That is,
  244. you don't have to position the highlight bar on it and then press enter.
  245.  
  246.      You may wish to use the file name currently indicated by the highlight
  247. bar as a parameter for the program you wish to execute.  You can speed your
  248. typing by firstly typing the name of the program you want to execute (which
  249. can be anywhere on the DOS path), then pressing Ctrl-Enter to pull down the
  250. text currently under the highlight bar.
  251.  
  252.       Press the up arrow key to bring up previously used DOS commands.  You
  253. don't have to type the same command again and again.
  254.  
  255.  
  256.  
  257. Execute a file:
  258.  
  259.      Press the return key to execute the file indicated by the highlight bar.
  260.  "Control 3" uses about 110 kb of memory (which includes a 60 kb copying
  261.  buffer), so don't expect to be able to run enormous programs from within
  262.  "Control 3".  If you do try to run a program that is too large to fit in the
  263.  memory of your computer you will be greeted with a "not enough memory"
  264.  message.
  265.  
  266.      If you try to execute programs from within "CONTROL 3" whilst you
  267. have memory resident programs or large virtual disks resident in memory you
  268. may have problems.  In this situation it is safer to execute these programs
  269. from DOS.
  270.  
  271.      You will be prompted for any parameters you wish to pass to the program.
  272. The instructions you give here are the command line parameters you would
  273. normally type after the filename from the Dos prompt.
  274.  
  275.      Control 3 saves the previous ten parameters used and these can be called
  276. up by pressing the up-arrow key.
  277.  
  278.      If you wish to pause after having executed the file and before returning
  279. to "Control 3" then enter a single space as a command line parameter as you
  280. execute the desired program.  This is useful if you wish to view possible
  281. Dos errors for example.
  282.  
  283.  
  284.  
  285.  
  286. Auto-execution
  287.  
  288.      You can treat files with certain extensions in specified ways.  For
  289. example, if the highlight bar is on a file with a '.ZIP' extension (a file
  290. compressed with pkzip), you can simply press the return key and automatically
  291. run a pkzip -v command on it, to view the contents of the archive.  Or, if
  292. the file is a .DOC or .TXT file, you can automatically run your favourite
  293. editor with the highlighted file as a parameter.  A sample .CFG file, which
  294. lists a few common file extensions and commands, is included in the package.
  295. You can have up to twelve extension-command pairs in the file.
  296.  
  297.      Use any ascii text editor, or control3's mini-editor to create a
  298. configuration file, containing the file extensions and commands you would
  299. like associated with them.  The file must be called C3.CFG and must be
  300. located on the DOS path so CONTROL3 can find it when it starts up.
  301.  
  302.      For example,
  303.  
  304.                       DOC LIST.EXE
  305.                       PAS TURBO.EXE
  306.  
  307.         Type the extension first (3 letters) followed by the
  308.         command you desire.  The two lines above, when placed in
  309.         the C3.CFG file will enable you to select .DOC files from
  310.         within CONTROL3 and you will automatically be able to view
  311.         them with the program LIST (provided you have a copy of the
  312.         popular program LIST, and the path is set up correctly).
  313.         Also, selecting a file with a .PAS extension from within
  314.         CONTROL3 will call up the TURBO editor, with the highlighted
  315.         file as the work file.
  316.  
  317.  
  318.  
  319.  
  320. Move a file:
  321.  
  322.      Use the "O" command (m"O"ve) to move files from one directory to another
  323. on the same drive.  The destination directory must be listed on the screen
  324. with the source directory.  This process is much faster than copying the
  325. files across and then deleting the originals.
  326.  
  327.      Directories cannot be moved with this command.  Use the directory copy
  328. and delete functions instead.
  329.  
  330.  
  331.  
  332.  
  333.  
  334. Copying files:
  335.  
  336.      Position the highlight bar over the file you wish to copy and press "C"
  337. (for "C"opy).  You will be prompted for the destination drive letter.  If the
  338. default is correct then press the return key to go ahead with the copy.
  339. If files have been tagged these will be copied also.
  340.  
  341.      If you wish to copy to a different directory on the same drive then
  342. you need to bring that directory up on the same screen with the source
  343. directory. To do this, list the source directory on the screen a second time
  344. and move into the desired destination directory. Then move back to the source
  345. directory and perform the copy.
  346.  
  347.      You will see the files displayed in their new location as soon as the
  348. copy is complete.
  349.  
  350.  
  351.  
  352.  
  353.  
  354. Copying directories:
  355.  
  356.      The process is the same as for copying files.  This function will
  357. copy ALL the files and directories within the chosen directory across
  358. to the current directory in the chosen target drive (which may be the
  359. same drive).
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Changing windows/drives:
  366.  
  367.      When you have more than one directory listed on the screen pushing the
  368. left or right arrow key will move you into an adjacent listing.
  369.  
  370.  
  371.  
  372.  
  373.  
  374. Rename a file:
  375.  
  376.      Position the highlight bar over the name you wish to change (which can
  377. be a directory name), then press "N" (for re"N"ame).  Type the new name and
  378. press the Return key to see your changes updated on the screen.
  379.  
  380.      It is possible to move a file into a different directory using this
  381. command.  To do this, include the destination directory name in the
  382. filename.
  383.  
  384.  
  385.  
  386.  
  387.  
  388. Delete a file:
  389.  
  390.      Position the highlight bar over the file to be deleted and press "D"
  391. (for "D"elete). You will be asked to verify the deletion with a yes/no or all.
  392. "All" will delete all tagged files.
  393.  
  394.  
  395.  
  396.  
  397.  
  398. View a text file:
  399.  
  400.      Position the highlight bar over the text file you wish to view (these
  401. normally have an extension of either ".DOC", ".TXT"  or ".ASC").  Press the
  402. spacebar to pause the scrolling or press the escape key to return to the
  403. control screen.
  404.  
  405.      Press 1..9 to change the speed of the scrolling.
  406.  
  407.  
  408.  
  409.  
  410.  
  411. Print a text file:
  412.  
  413.       Position the highlight bar over the text file to print and press the
  414. "P" key.  You will then be asked to verify that the printer is ready.
  415. Make sure that the printer is both on and on-line.
  416.  
  417.  
  418.  
  419.  
  420.  
  421. Tagging files:
  422.  
  423.      If you wish to delete or copy more than one file you can tag as many as
  424. you like by pressing "Ctrl-T" to tag all the files in the current directory,
  425. or by pressing the space bar to tag and untag individual files.  Beware ...
  426. the file beneath the highlight bar when you do the deletion or copy will be
  427. treated as though it were tagged even if you do not specifically tag the file.
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434. Encrypting and de-crypting files:
  435.  
  436.    This encryption program modified from "PC magazine" pp 376-383 Jan 12th
  437. 1988.  This is just the thing you need to make sure that no un-authorized
  438. person can use your programs and read your personal documents (should you
  439. have something to hide!).
  440.  
  441.    To encrypt a file, position the highlight bar over the file you wish to
  442. encrypt, then press Ctrl-E.  Enter a password - and remember it !  The file
  443. will then be written out over the original in encrypted form, and will be
  444. rendered unusable and unreadable.
  445.  
  446.    To de-crypt go through exactly the same procedure, using the same password.
  447.  
  448.    When you enter your password you will be asked to verify with a "Y" or
  449. "N" whether the password is correct.  Should you make a mistake, the file
  450. will be de-crypted incorrectly.  To recover from this mistake you must
  451. run the encryption program again with the faulty password to get the
  452. file back to its previous state, and then use the correct password.
  453.  
  454.  
  455.  
  456.  
  457.  
  458. The "Touch" facility:
  459.  
  460.     Select any number of files and press "T" to touch-up the time and
  461. date recorded on each selected file to the current time and date.  If
  462. you have the information window displayed you can see this happening.
  463.  
  464.  
  465.  
  466.  
  467.  
  468. The "Find string" command:
  469.  
  470.     This is a very useful function for when you want to locate a particular
  471. series of characters (called a "string").  For example, you may have a whole
  472. diskette full of source code files for your programs, and wish to locate a
  473. single variable name.  In this case, tag all the files on the disk and then
  474. press Ctrl-F.  Type in the series of characters you wish to locate.  If the
  475. string is found, the line of text containing it will be printed along with
  476. the line number.
  477.  
  478.     Use the spacebar to pause scrolling.
  479.  
  480.     If you select '.COM' or '.EXE' files, all printable strings greater
  481. than or equal to five characters will be listed onto the screen.  Look
  482. through the error messages of a file to discover its limitations.  This
  483. feature can also be useful in getting a better idea of what an unknown
  484. program actually does, and can even detect the possibility of "viruses"
  485. or "bombs" (though this doesn't always work).  If you see suspect strings
  486. printed onto the screen, such as "gotcha..." then think twice before
  487. running the program! With executable files ALL strings will be returned,
  488. regardless of the search string you typed in.
  489.  
  490.  
  491.  
  492.  
  493.  
  494. Changing the attributes of a file:
  495.  
  496.  
  497.     Ctrl-A will enable you to type in changes you wish to make to the
  498. attributes of a file.
  499.  
  500.                  For example, if you were to type in
  501.  
  502.                               sha
  503.  
  504.    the attributes would be changed to system file + hidden + archive.
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511. Shell to DOS:
  512.  
  513.      Press Ctrl-O.  You can then perform any Dos command as you normally
  514. would from Dos.  Type "EXIT" from the Dos prompt at any time to return to
  515. the program where you left it.
  516.  
  517.  
  518.  
  519.  
  520.  
  521. File information:
  522.  
  523.      Position the highlight bar over the file and press "I".  You can now
  524. use the arrows to move about between files while viewing the time the
  525. file was last written and its attributes.  Press the escape key to exit
  526. "file information".
  527.  
  528.  
  529.  
  530.  
  531.  
  532. Maximum files in any one directory:
  533.  
  534.         "Control 3" will truncate the directory listing at 500 files,
  535. following a warning.  You can have as many files on any one disk as you
  536. like, as long as there are no more than 500 in any one subdirectory.
  537. If you use a hard disk with many files you may want to create subdirectories
  538. and move some files into them.
  539.  
  540.  
  541.  
  542.  
  543.  
  544. Changing the system time and date::
  545.  
  546.        Ctrl-D will prompt you to enter a new date and then the time.
  547.  
  548.         Examples:
  549.                  Times                          Dates
  550.  
  551.                    2:05                        20-1-88
  552.                14:45:30                        2-11-88
  553.                   22:11                         4-5-88
  554.  
  555.        If you do not see the correct changes made on the screen immediately
  556. then you have entered the time or date incorrectly.  Try again.
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564. The Mini Editor:
  565.  
  566.       To edit an existing text file (must be less than 25 lines in length)
  567. position the highlight bar over the file, press "E" and then press
  568. the number "1".   Alternatively, to create a new file, press "E" followed
  569. by "2".  Press F1 for help.
  570.  
  571.       You can edit lines up to 120 characters in length.
  572.  
  573.  
  574.     Editing keys are:
  575.  
  576.       left and right arrows : move the cursor left  and right without
  577.                               changing the text.
  578.  
  579.       up and down arrows : move the cursor up and down a single row without
  580.                            changing the text.
  581.  
  582.       backspace : moves the cursor one position to the left and deletes the
  583.                   character at that position.
  584.  
  585.       Home/End : moves the cursor to the beginning and end of the current
  586.                  line.
  587.  
  588.       Insert : Press the "Ins" key to toggle the insert mode.  A large cursor
  589.                indicates that insert mode is on.  With insert mode on,
  590.                any characters you type in will be inserted into the line
  591.                at the current cursor position, with all text to the right
  592.                of the cursor being pushed further to the right.
  593.  
  594.                Pressing the return key whilst insert mode is on will insert
  595.                a new line into the text.
  596.  
  597.       Ctrl-Y : Press "Y" whilst holding down the control key to delete
  598.                a whole line from the text.  All lines below will be
  599.                moved up one line.
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608. Escape to Dos:
  609.  
  610.        Press "Esc" to escape to Dos and into the original directory you
  611. were in when you first executed "Control 2".  Alternatively, press "Q" if
  612. you wish to quit into the current directory shown within "Control 2".
  613.  
  614.  
  615.  
  616.  
  617.  
  618. Command line parameters:
  619.  
  620.       ... to alter the default settings.
  621.  
  622.       "?"  for help     eg  Control3 ?
  623.  
  624.       "U" to leave files unsorted by default.  This will result in faster
  625.           operations if you are dealing with many hundreds of files
  626.  
  627.       "E" to sort automatically by extension.
  628.  
  629.       "T" to be prompted to enter the date and time (very useful if you want
  630.           your files to have the correct times)
  631.  
  632.       "H" to keep hidden files hidden.
  633.  
  634.       "O" to turn off colour of filenames.
  635.  
  636.       "P" for filenames in capitals.
  637.  
  638.       "D" for filenames with dots.
  639.  
  640.       "M" for mono-system, or "C" for colour only if this program has trouble
  641.           detecting what type of system you have (you will be able to tell if
  642.           information is not being displayed properly).
  643.  
  644.  
  645.                    For example:
  646.  
  647.                        Control2 u s t
  648.  
  649.                           when starting up will run the program without
  650.                           automatic sorting, without snow checking, and
  651.                           will prompt you for the date and time.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658. Tricks and tips:
  659.  
  660.  
  661.      *  If you have a whole pile of floppy disks, and you know the file
  662.         you are looking for is somewhere amongst those disks, then use the
  663.         "file specification" option.
  664.           For example, lets say you want to find the file UTILS84.DOC.
  665.         Press "F" and then enter the command
  666.  
  667.                                uti*.doc
  668.  
  669.           Feed in floppies with one hand and press "L" to log them with
  670.         the other.  If a file is found with this specification it will
  671.         be listed, otherwise you will be told there have been "NONE FOUND".
  672.  
  673.  
  674.  
  675.      *  This program will automatically sort your files alphabetically by
  676.         default.  However, if you like to have your files in order on disk
  677.         this can be achieved by using the "Move" command.  Create a
  678.         directory and move all your files into it, then move them back again.
  679.         Your files will now be in order on disk!
  680.  
  681.  
  682.  
  683.      *  If you use the command line options a lot it will save you time to
  684.         create batch files, and run these instead.
  685.  
  686.          For example,
  687.            Press "E" and then "2" to get into the editor to create a file.
  688.  
  689.            then type
  690.  
  691.             control3 e p d t   {or whichever parameters you choose}
  692.  
  693.               and then save it under the name "con3.bat".
  694.  
  695.               You can then run "CONTROL3" with date and time prompting, sorting
  696.          by extension, and with filenames in capitals and dots, simply enter
  697.          "con3" from the Dos prompt and press return.
  698.  
  699.               You may want to run "CONTROL3" from an autoexec file.  In this
  700.          case save the file under the name "autoexec.bat".
  701.  
  702.           Use different batch files for different options.
  703.  
  704.  
  705.      *  Print labels for your floppy diskettes by displaying the directory
  706.         of the disk on the screen and then printing the screen.
  707.         Do this by firstly making sure the printer is ON and ON-LINE and
  708.         then pressing Shift-PrtSc.
  709.         Cut out the directory list and then slip it inside your diskette
  710.         cover.  This is rough, but useful.
  711.  
  712.  
  713.      *  If you need to consult documentation to be able to operate one of
  714.         your programs, rather than scrolling through the whole document
  715.         with the text file viewer save time and effort using the "find"
  716.         utility.  Use an appropriate key word, such as "copy" if you wish
  717.         to locate information on copying.  You will often be able find
  718.         out what you need from the text displayed.
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726. Help:
  727.  
  728.        Pressing "H" at any time will immediately display the remainder of
  729. the commands available to you.
  730.  
  731.  
  732.  
  733.  
  734.  
  735. ******************************************************************************
  736.  
  737.  
  738. LICENCE:
  739.  
  740.    Copyright (c) 1991         Kevin Solway.        All rights reserved.
  741.  
  742.    This program is provided AS IS without warranty, expressed or implied.
  743.  
  744.        Under no circumstances is this program to be sold, except where clubs
  745.    distribute programs without profit.
  746.  
  747.        This program is being released under the shareware concept, if you
  748.    find this program useful you are required to send a registration fee
  749.    of $20 to me at the address below.  Include an extra $5 if you want
  750.    information about updates.
  751.  
  752.  
  753.     Remit to:             Kevin Solway
  754.                           P.O Box 207
  755.                           St Lucia  4067
  756.                           Queensland
  757.                           Australia
  758.  
  759.  
  760. *******************************************************************************
  761.